home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / nmfw205.zip / NMFWD.DOC < prev    next >
Text File  |  1996-06-18  |  24KB  |  595 lines
  1.         **************************************************************
  2.         *                                                            *
  3.         *                                                            *
  4.         *            **   ** **   ** ******* **   ** *****           *
  5.         *            ***  ** *** ***  **   * **   **  ** **          *
  6.         *            **** ** *******  ** *   **   **  **  **         *
  7.         *            ** **** *******  ****   ** * **  **  **         *
  8.         *            **  *** ** * **  ** *   *******  **  **         *
  9.         *            **   ** **   **  **     *** ***  ** **          *
  10.         *            **   ** **   ** ****     *   *  *****           *
  11.         *                                                            *
  12.         *                                                            *
  13.         *                        Version 2.05                        *
  14.         *                                                            *
  15.         *          A powerful Multi-Robot for Maximus/Squish         *
  16.         *                                                            *
  17.         *                                                            *
  18.         **************************************************************
  19.         *                                                            *
  20.         *       (C) Copyright 1991-1996  Alberto Pasquale            *
  21.         *                                                            *
  22.         *           A L L   R I G H T S   R E S E R V E D            *
  23.         *                                                            *
  24.         **************************************************************
  25.         
  26.         
  27.           "Maximus" and "Squish" are trademarks of Lanius Corporation
  28.         
  29.         
  30.  
  31.                 NmFwd 2.05 User's Manual, by Alberto Pasquale
  32.         
  33.         
  34.                                   INTRODUCTION
  35.         
  36.         
  37.         -> For licensing information, please see License.Doc.
  38.         
  39.         Thanks for evaluating NmFwd: a multi-robot for Maximus/Squish.
  40.         
  41.                                  Main Features
  42.         
  43.         
  44.         - To be used with Squish mail processor and Maximus 3.xx CBCS
  45.           (Trademarks of Lanius Corporation).
  46.           A BinkleyTerm style outbound is required for some features.
  47.         
  48.         - Works on *.MSG or SQUISH netmail area.
  49.         
  50.         - Total or partial forward of NetMail area to (Co)SysOp's point.
  51.         
  52.         - Selective Flag (Crash, Direct) Stripping.
  53.         
  54.         - 3D and 4D point handling (even mixed).
  55.         
  56.         - Boss Routing capability to BossRoute all the crash and direct
  57.           messages addressed to points that are not found in your V7
  58.           nodelist or have a null phone number.
  59.         
  60.         - Point Remapping based on To-Name.
  61.         
  62.         - FileAttach forwarding between points in a dedicated directory,
  63.           with optional automatic file-killing after configured time.
  64.         
  65.         - Automatic Upload for Points via NetMail Robot.
  66.         
  67.         - Complete User Management functions via NetMail Robot (Max 3.xx).
  68.         
  69.         - Complete File Management functions via NetMail Robot (Max 3.xx),
  70.           with flexible privilege and keys handling.
  71.         
  72.         - Automatic (internal) filebase update.
  73.         
  74.         - Areafix functions for Squish.Cfg.
  75.         
  76.         - Return To Sender functions to stop messages addressed to
  77.           unlisted nodes and routed echomail (based on V7 nodelist).
  78.         
  79.         - Support for the V7 .BSY semaphore, as per FastLst specs.
  80.         
  81.         - Return Receipt generation for messages that have the RRQ
  82.           flag set or the "*RR*" string in their subject (standard
  83.           proposed by Alex Palmese of 2:335/317).
  84.         
  85.         
  86.                                     CREDITS
  87.         
  88.         "BinkleyTerm" is a trademark of Bit Bucket Software Co.
  89.         
  90.         This program uses the Squish "MsgAPI" code, Copyright 1991-1994
  91.         by Lanius Corporation. "Squish" and "Maximus" are trademarks of
  92.         Lanius Corporation.
  93.         
  94.  
  95.         
  96.                                OVERALL OPERATION
  97.         
  98.         
  99.         To speed up netmail scanning, NmFwd scans only new messages. To
  100.         accomplish this, it uses an advanced algorithm for *.MSG (the
  101.         necessary information is stored in the NMFWDDIR.DAT located in
  102.         the related directory) and the UID (Unique ID) for the Squish
  103.         base (stored in the <netmail>.NFD file).
  104.         
  105.         In the case you change a message after it has been processed
  106.         (Squish base), it will not be rescanned. So, if you want it
  107.         processed, you must copy then change, not simply change the
  108.         message.
  109.         
  110.         All the messages addressed to your points are directly packed
  111.         to *.?ut in the OUTBOUND.SQ by NmFwd. This is necessary to
  112.         allow correct operations of the Netmail Forwarding functions in
  113.         a mixed 3D-4D environment and for the BossRoute option.
  114.         
  115.         
  116.                                  FLAGS HANDLING
  117.         
  118.         
  119.         If the original message has one of the following flags
  120.         (FileRequest, UpdateRequest), the forwarded one will have a
  121.         two letter upper-case symbol on the first line (FR, UR).
  122.         
  123.         If a Crash message comes from a point authorized to send DM
  124.         only, the Hold attribute is set in order to change the Crash
  125.         flavour to Direct (Squish handles the sum of Crash and Hold
  126.         as Direct). The forwarded copy will have a "cm" lower-case
  127.         symbol on the first line of the message.
  128.         
  129.         If a Crash message comes from a system that is not authorized
  130.         to send neither Crash nor Direct mail, the crash flag will be
  131.         reset and a "cm" symbol will be inserted in forwarded copies.
  132.         
  133.         If a Direct message (Crash and Hold flags set) comes from a
  134.         system that is not authorized, the crash and hold flags will
  135.         be reset and the "dm" symbol will be inserted in forwarded
  136.         copies.
  137.         
  138.         
  139.         
  140.                                   INSTALLATION
  141.         
  142.         
  143.         1) (OS/2): Make sure you have the MSGAPI32.DLL in a directory
  144.              contained in your LIBPATH and the PmHatch.Exe program in
  145.              your PATH. MSGAPI32.DLL can be found in the Squish 1.11
  146.              archive (SQSHP111.LZH).
  147.         
  148.            (NT): Make sure you have the MSGAPINT.DLL in a directory
  149.              contained in your PATH. MSGAPINT.DLL can be found in the
  150.              Max 3.01 for Windows archive (MAX301N.ZIP).
  151.         
  152.            (DOS): Make sure you have the DOS4GW.EXE Dos extender (from
  153.              Rational System Inc.) in your path.
  154.         
  155.              The DOS4GW extender requires an XMS or DPMI memory driver
  156.              installed in your config.sys: e.g. HIMEM.SYS, QEMM (by
  157.              QuarterDeck Office Systems Inc.).
  158.         
  159.         2) Edit nmfwd.cfg following the comments in it.
  160.         
  161.         3) Edit your batch file in order to call nmfwd BEFORE netmail
  162.            packing.
  163.         
  164.            Example 1 (two pass):
  165.         
  166.                     Squish In Out
  167.                     NmFwd
  168.                     Squish Squash -sNrm
  169.         
  170.            Example 2 (one pass):
  171.         
  172.                     Squish In Out Squash -o -sNrm
  173.                     NmFwd
  174.                     Squish Squash -sNrm
  175.         
  176.            Note: - The -o switch prevents squish from packing netmail
  177.                    before Nmfwd has a chance to process it.
  178.                  - You may need additional calls to squish to process
  179.                    echomail generated locally.
  180.         
  181.            Example 3 (separate echo and netmail routing, SqPrv local
  182.                       echomail processor and Nef tic processor used):
  183.         
  184.            sqrem
  185.            squish in out squash -sECHO -o
  186.            nef
  187.            squnrem
  188.            sq